LiveCode 9.0.1 Release Notes 9/11/18 
LiveCode 9.0.1 Release Notes 


e Overview 
e Known issues 
e Breaking changes 


o Standalone Building 
o LiveCode Builder 


e Platform support 


0 Windows 
o Linux 

o Mac 

o iOS 

o Android 
°0 HTML5 


o Installation 

o Uninstallation 

o Reporting installer issues 

o Activating LiveCode Indy or Business edition 

°0 Command-line installation 

°0 Command-line uninstallation 

© Command-line activation for LiveCode Indy or Business edition 


e LiveCode Community engine changes 


o Android 6.0 runtime permissions 

o Newstereo panning properties added to MacOSX Player object 

o Support resizing stacks for orientation changes in fullscreen modes 
o Specific engine bug fixes (9.0.1-rc-3) 

° Specific engine bug fixes (9.0.1-rc-2) 

o Specific engine bug fixes (9.0.1-rc-1) 


e LiveCode Community IDE changes 
o Specific IDE bug fixes (9.0.1-rc-1) 
e LiveCode Community extension changes 
° Specific extension bug fixes (9.0.1-rc-1) 
e LiveCode Community Plus IDE changes 
o Specific IDE bug fixes (9.0.1-rc-1) 
e LiveCode Indy extension changes 
o Specific extension bug fixes (9.0.1-rc-1) 


e LiveCode builder changes 


LiveCode 9.0.1 Release Notes 9/11/18 


o LiveCode Builder Virtual Machine 
o LiveCode Builder Language 
o Specific builder bug fixes (9.0.1-rc-1) 


e Dictionary additions 
e Previous release notes 


OV) aVA=a) 





LiveCode 9.0 enables access to libraries and platform APIs written in many other languages 
thanks to the community-funded ‘Infinite LiveCode' project. 


This includes a greatly improved LiveCode Builder virtual machine. 


LiveCode 9.0 contains many additional improvements to support LiveCode app developers, 
including: 


e Anew "spinner" widget 
e OAuth2 authentication library for use with web APIs (e.g. Facebook, Google and GitHub) 
e Acommand argument parser library for building command-line standalones 


e Updates and performance improvements for existing widgets 
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e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 


e 64-bit standalones for Mac OS X do not have support for audio recording. 
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Standalone Building 


The standalone builder has always needed to close the stacks it builds for reasons pretty deeply 
ingrained in the code. However this causes a few problems, for example: 


e values in script locals become empty 
e behaviors are broken when the parent script is on / in a stack which closes 
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As an attempt to improve this situation, the code that locks messages when closing and opening 
Stacks for standalone builds has been removed. This means that where previously mainstacks 
would not receive openStack and closeStack messages during standalone build, they now do. 


If this causes problems for your stack, you can exit from the handler if standalone building is in 
progress: 


on closeStack 
if the mode of stack "revStandaloneProgress" > @ then 
exit closesStack 
end if 
end closeStack 


LiveCode Builder 


Ex ponentiation operator precedence 

Prior to this release, exponentiation had lower precedence that unary minus. In order to write 
code that operates as expected in both this release and previous releases, please use 
parentheses where appropriate. 

Using Ic-compile tool in LiveCode 9: 

-1%2 = -1 


Using Ic-compile tool in LiveCode 8: 
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The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 
LiveCode supports the following versions of Windows: 


e Windows 7 (both 32-bit and 64-bit) 
e Windows Server 2008 
e Windows 8.x (Desktop) 
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e Windows 10 


Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 


Linux 


LiveCode supports the following Linux distributions, on 32-bit or 64-bit Intel/AMD or compatible 
processors: 


e Ubuntu 14.04 and 16.04 

e Fedora 23 & 24 

e Debian 7 (Wheezy) and 8 (Jessie) [server] 
e CentOS 7 [server] 


LiveCode may also run on Linux installations which meet the following requirements: 
e Required dependencies for core functionality: 


o glibc 2.13 or later 
o glib 2.0 or later 


e Optional requirements for GUI functionality: 


°0 GTK/GDK 2.24 or later 

o Pango with Xft support 

°o esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

°o Icms (optional, required for color profile Support in images) 
° gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 


The Mac engine supports: 


e 10.9.x (Mavericks) on Intel 

e 10.10.x (Yosemite) on Intel 

e 10.11.x (El Capitan) on Intel 
e 10.12.x (Sierra) on Intel 

e 10.13.x (High Sierra) on Intel 


iOS 
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IOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 


e Xcode 6.2 on MacOS X 10.9 

e Xcode 6.2 and 7.2 on Mac OS X 10.10 

e Xcode 8.2 on MacOS X 10.11 

e Xcode 9.2 on MacOS 10.12 (Note: You need to upgrade to 10.12.6) 
e Xcode 9.4 on MacOS 10.13 (Note: You need to upgrade to 10.13.2) 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
simulators. For instance, on MacOS 10.12 (Sierra), you can add Xcode 6.2 in the Mobile Support 
preferences, to let you test your stack on the /OS Simulator 8.2. 


We currently support deployment for the following versions of iOS: 


e 8.2 [simulator] 
e 9.2 

e 10.2 

e 11.2 

e 11.4 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


The Android engine supports devices using ARMv7 or ARMV8 processors. It will run on the following 
versions of Android: 


e 4.1-4.3 Jelly Bean) 
e 4.4 (KitKat) 

e 5.0-5.1 (Lollipop) 
e 6.0 (Marshmallow) 
e 7.0 (Nougat) 

e 8.0 (Oreo) 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the ‘Android SDK Manager' to install: 


e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
“openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 


Some users have reported successful Android Watch deployment, but it is not officially supported. 
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HTMLS5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTML5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently Supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 


Setup 





Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS xX, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 


Linux /opt/livecode/livecode-<version> 


The installations when installing for "This User" are: 


Platform Path 

Windows (eae Ue data folder>/RunRev/Components/LiveCode 
<version> 

Linux ~/.runrev/components/livecode-<version> 


Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS X, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
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LiveCode's installation directory. 


Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 


Run the installer using a command in the form: 


<installer> install noui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 


the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 


The installer understands any of the following OPTIONs: 
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Option Description 


Install the IDE for "All Users". If not specified, LiveCode will be installed 


-allusers 
for the current user only. 


Place a shortcut on the Desktop (Windows-only) 


desktopshortcut 

-startmenu Place shortcuts in the Start Menu (Windows-only) 

-location The folder to install into. If not specified, the LOCATION defaults to those 
LOCATION described in the "Installation" section above. 

Sisap hoe aa nee al to log installation actions. If not specified, no log is 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <installer> install noui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 


Run the uninstaller using a command of the form: 
<uninstaller> uninstall noui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 
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<livecode> activate -file LICENSEFILE -passphrase SECRET 


where <livecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 
given SECRET passphrase, and installs a license file for all users of the computer. Manual 


activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 

<Livecode> deactivate 

Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <livecode> activate -file LICENSE -passphrase SECRET 
Start /wait <livecode> deactivate 


On Mac OS X, you need to do: 


<Livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<Livecode>/Contents/MacOS/LiveCode deactivate 
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Android 6.0 runtime permissions 


Android 6.0 (API 23) Marshmallow introduced a new permissions model that lets apps request 
permissions from the user at runtime, rather than prior to installation. Apps built with LC 9.0.1 do 
Support this new permissions model, and request permissions automatically when the app 
actually requires the services or data protected by the services. 


For example, if the app calls mobilePickPhoto "camera", a dialog will be shown to the user 
asking for permission to access the device camera. 


If the user does not grant permission, the call will fail. Moreover, the app can use the function 
androidRequestPermission(permissionName) to check if the permission for 


permissionName has been granted. 


Notes: 
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e You have to make sure that you check the required permissions for your app in the 
Standalone settings. 

e Apps that run on devices running Android 6+ will work with the new permissions model. 

e Apps that run on older devices (less than Android 6) will continue to work with the old 
permissions model. 

e If the user does not grant a permission when the dialog appears for the first time, they can 
change this preference from the Settings app. 


New stereo panning properties added to MacOSX Player object 


leftBalance: control the volume of the left stereo channel. rightBalance: control the volume of the 
right stereo channel. audioPan: pan audio from one stereo channel to another. 


Note: these properties currently require media files to have stereo audio tracks. There will be no 
effect on mono or surround-sound formats. 


Support resizing stacks for orientation changes in fullscreen 


modes 


A new mobile command mobileSetFullScreenRectForOrientations has been implemented 


to allow stacks that use the fullscreenMode property to be resized when the device orientation 


changes. 


Specific engine bug fixes (9.0.1-rc-3) 


21552 


Fix dragData clearing between mouseDown and dragStart 


Specific engine bug fixes (9.0.1-rc-2) 


21396 
21417 
21434 
21443 
21496 


Fix crash on startup in iOS 12 beta 

Don't include any externals in emscripten standalones 

Fix visual effects not working when acceleratedRendering is true on Android 
Fix groups sometimes not redrawing when scrolled 

Ensure emscripten aux stacks are loaded on startup 


Specific engine bug fixes (9.0.1-rc-1) 


10694 


12431 
12675 
13266 
15086 


Ensure the standalone builder throws an error if the Android SDK path is not set or is 
invalid 

Ensure .otf font files are recognized on iOS and Android 

Ensure sound can be queued with mobilePlaySoundOnChannel on Android 

Ensure option menu works on Android 

Included mention of usePixelScaling's error throwing behaviour on Android. 
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15443 
15614 


16366 


16736 
19094 


19465 


19651 
19900 
20016 
20211 
20550 
20551 
20502 
20570 
20631 


20678 


20839 
20925 
20997 
21019 
21049 


21051 


21062 
21141 
ZLIS5 
21161 
21171 
21184 
21207 
ZIZ17 
21228 
21234 
21246 
21250 
21253 
71274 
21278 


Z1279 


21280 
Z1302 
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Ensure caseless comparison of native strings works on Mac 

Fixed incorrect example in the dictionary entry for URLEncode. 

Ensure the area outside the stack rect is re-rendered when going to a newcard in 
fullscreen mode showAll 


Fix crash when relayering objects with accelerated rendering true 

Ensure single-codepoint grapheme clusters are checked for font support 
Change the orientation on Android when mobileSetAllowedOrientations does 
not allow the current orientation 

Windows: Fix incorrect video output for some formats when playing mirrored 
Ensure tsNet external can be unloaded 

DataGrids completely unresponsive in HTML 5 standalones 

Fix Mac player crash when setting filename multiple times 

Update ExtVideoView module to compile against API 19 

Android: Update Notification module to compile against API 23 

Android: Replace deprecated method of transferring file data to/from other apps 
revDB: Fix MySQL errors after calling stored procedures 

Fix crash when launching or resuming android app from local notification 
Ensure that when the clipboard only has private data it will be updated when the 
system clipboard changes 

Improve appearance of disabled buttons when using Motif look-and-feel 

Fix crash when repeatedly dragging 

Add tsNet builds for iOS SDK 11.3 

Support resizing stacks for orientation changes in fullscreen modes 

Add appropriate errors for the fontLanguage 

Ensure revDataFromQuery on an ODBC database does not return incomplete 
unicode strings 

Fix detection of HTTP digest authentication with tsNet 

Fixed errors when setting textFont/textSize on Android native button 

Fix JavaScript error when closing stack window in HTML5 standalone 

LiveCode trials do not start on Windows 

Ensure unicode characters in app label are shown correctly on Android 

Ensure play command can play a remote auriofile on iOS 

Ensure ‘relaunch’ handler is found when declared in parentscript 

Prevent crash when calling quit from a stack with a non empty imagesource 
Ensure android working screenrect is updated when the keyboard is presented 
Dictionary: revDataFromQuery / revQueryDatabase updates 

Fix crash using windows clipboard 

Fix crash which may occur when selected objects are deleted 

Build iOS 11.4 binaries for the tsNet external 

Fix crash when setting the markerpoints of a graphic in a repeat loop 

Ensure playrate is respected when looping and when playing after a pause 
Ensure objects are clipped correctly when rendering fullscreen mode leterbox with 
acceleratedRendering true 

Fix crash when setting the styledText of a long field to its styledText 

Make message box 'put' statements immune to ‘lock messages' 
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wad 7 | 
21326 
21336 
21302 
21356 
21368 
21386 
21395 
21398 
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Fix crash when getting the hostnametoaddress without param 

Ensure binary strings remain so when binary string is appended or prepended 
Ensure only the top stack will render on mobile 

Android: fix potential crash on relaunch due to uninitialized static variable 

Fix black screen on Android when setting acceleratedRendering at startup 

Ensure push notifications work on Android when targetSdkVersion=26 

Fix widgets with native layers not being clipped by their parent group rect on iOS 
Fix MacOSX player control not starting when playRate property is 0 

Do not split up .framework folders between MacOS and Resources/_MacOS folder 
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Specific IDE bug fixes (9.0.1-rc-1) 


18585 
19504 
19998 
20094 
20672 


21017 


21086 
Z1122 
21167 
21169 
21172 
21174 
21176 
Z1179 
21202 
21206 
21222 
21232 
ZipZS 


Ensure Dictionary does not pass cmd+A 

Allow entry of tabs into the text property field of the property inspector 

Add default points for polygon graphic 

Fix multi-line message box not executing if the first line is a comment 

Fix very slow arrow key nudge of multiple objects 

Add resizeControl to the list of handlers not to trace in the debugger as doing so 
locks up the IDE 

Keep correct selection when formatting whole script 

Fix user stacks opening offscreen when last opened on a different monitor 
Ensure Replace history is remembered 

Ensure splash screen always hides on Windows 

Fix revMail on mobile 

Ensure "Sample Stacks" window does show up in menu "Windows" 

Make sure the Start Center can always show the Upgrade Options 

Add 'show documentation’ option to contextual menu in extension manager 
Fix deselection of next find after replace in Script Editor 

Fix execution error opening message box from script editor via Cmd/Ctril+M 
Ensure File -> Close option is disabled when the topstack is stack revMenubar 
Fix wandering breakpoints when undoing paste 

correction to syntax for DG2's new props 
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Specific extension bug fixes (9.0.1-rc-1) 


19753 Prevent chunk out of range error on Linux when clicking selection 

20142 Prevent index errors when expanding TreeView buffer beyond 1000 keys 
21203 Only post hiliteChanged when value actually changes 

21345 Ensure the "horizontal" property of segmented control widget is saved 


EAV{=1 Goro [=m Gro) palanleralia’al ed leiom |B) mmxel al- laters 





Specific IDE bug fixes (9.0.1-rc-1) 


20975 Obscure pasted and dragged passwords in the activation dialog 
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Specific extension bug fixes (9.0.1-rc-1) 


21125 Fix missing docs references 
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LiveCode Builder Virtual Machine 


Array and list assign ops 


Previously there was a difference between constructing a list or array using push or put and 
using list or array assigment expressions [] and {}, namely values were converted to 
Optional any only in the latter case. For consistency, they are now converted in both cases. 


LiveCode Builder Language 


Nullable aggregate fields 


e Aggregate fields of Pointer type can nowcontain nothing, i.e. null pointers 
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Specific builder bug fixes (9.0.1-rc-1) 


20931 Values should bridge to optional any in array and list assign 
Ensure multi-module assembly manifest requires encompass support module use 
clauses 


21297 Fix issue with importing foreign value types that require conversion 


21064 
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e androidHasPermission (function) has been added to the dictionary. 

e androidPermissionExists (function) has been added to the dictionary. 

e androidRequestPermission (command) has been added to the dictionary. 
e audioPan (property) has been added to the dictionary. 

e leftBalance (property) has been added to the dictionary. 

e messageDigest (function) has been added to the dictionary. 

e rightBalance (property) has been added to the dictionary. 
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